---
title: 第一篇文章
date: 2025-12-06
---

完整 YAML 格式要求

---
title: 文章标题（必填）
date: 2025-03-15（必填，格式：YYYY-MM-DD）
tags: [标签1, 标签2]（选填，默认为空列表）
category: 技术分类（选填，默认为"未分类"）
series: 系列专栏名称（选填，默认为"未归集"）
summary: 文章摘要（选填，默认同标题）
status: finished（选填，默认为"finished"）
readtime: 5（选填，自动计算字数÷250）
draft: false（选填，设为true则不发布）
---

字段详解

字段 类型 必填 默认值 说明
title string ✅ 是 文件名 文章标题
date date ✅ 是 None 发布日期，格式 2025-12-06
tags list ❌ 否 [] 标签数组，如 [Python, FastAPI]
category string ❌ 否 "未分类" 文章分类
series string ❌ 否 "未归集" 系列/专栏名称
summary string ❌ 否 title 文章摘要，用于卡片展示
status string ❌ 否 "finished" 文章状态：finished, wip, abandoned
readtime int ❌ 否 自动计算 阅读时长（分钟）
draft bool ❌ 否 false 草稿状态，true则不显示

状态值说明

ALLOW_STATUS = {
    'finished': {'cn': '已完成', 'en': 'Finished'},   # 已完成
    'wip': {'cn': '进行中', 'en': 'WIP'},              # 连载中
    'abandoned': {'cn': '已弃坑', 'en': 'Abandoned'},  # 已弃坑
}

完整示例

---
title: FastAPI 静态网站生成器实战
date: 2025-12-06
tags: [FastAPI, Python, Web开发, SSG]
category: Web开发
series: FastAPI 进阶教程
summary: 本文详细介绍如何使用 FastAPI 构建高性能的静态网站生成器...
status: finished
readtime: 8
---

注意事项

  1. 日期格式：必须是 YYYY-MM-DD 格式（如 2025-12-06）
  2. 标签格式：推荐使用列表语法 [tag1, tag2]，也可使用多行 - tag1 格式
  3. 草稿处理：设置 draft: true 时，文章会被过滤不显示
  4. 状态值：只能使用 finished, wip, abandoned 之一，其他值会被重置为 finished
  5. 阅读时长：如果未指定，自动按 字数 ÷ 250字/分钟 计算
  6. 特殊字符：标题、标签等支持中文和英文

最小必需格式

---
title: 我的第一篇文章
date: 2025-12-06
---

其他字段均为可选，系统会自动填充默认值。